.. _`Split on key JSON`:

.. _`org.sysess.sympathy.data.json.splitonkeyjson`:

Split on key JSON
`````````````````

.. image:: split_json_key.svg
   :width: 48


Split a JSON structure into multiple JSONs




Documentation
:::::::::::::

Select key in a JSON structure and split into multiple JSONs based on that
key.
Will only select the first occurrence of the key
The special key ``<root>`` splits the JSON based on the root key

For example the JSON:

.. code-block:: python

    {
        "version":"1.0",
        "items" : [
            {
                "a":"1",
                "b":"2",
                "c":"3"
            },
            {
                "g":"1",
                "h":"2",
                "j":"3"
            }
        ]
    }

can be splitted on the key ``"items"``, which will produce two new JSONs

.. code-block:: python

    {
        "a":"1",
        "b":"2",
        "c":"3"
    }

and

.. code-block:: python

    {
        "g":"1",
        "h":"2",
        "j":"3"
    }


Definition
::::::::::


Input ports
...........

    **input**  json
        Input


Output ports
............

    **output**  [json]
        Output




Configuration
.............

    **JSON key** (key)
        The key to select








Implementation
..............

.. automodule:: node_select_json
    :noindex:

.. class:: SplitOnKeyJson
    :noindex: